home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / ARCHIVE / DIFF110.ZIP;1 / DIFF.DOC < prev    next >
Encoding:
Text File  |  1993-12-16  |  34.7 KB  |  1,136 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                                                      DIFF
  18.         _________________________________________________________________
  19.  
  20.                                                        File/Directory/ZIP 
  21.                                                                Difference 
  22.                                                                   Utility
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                                                     U S E R S   G U I D E
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.                                                              Version 1.10
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                                                                ⁄ƒƒƒƒƒƒƒƒø
  54.                                       C.SITTE SOFTWARETECHNIK  ≥c.sitte ≥
  55.                                                   Postfach 42  ≥software≥
  56.                                      A-5025 Salzburg, Austria  ≥technik ≥
  57.                                                                ¿ƒƒƒƒƒƒƒƒŸ
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.         EDITION
  69.  
  70.         November 1993
  71.         (C) Copyright 1993 by C.Sitte Softwaretechnik 
  72.         All rights reserved
  73.  
  74.  
  75.         NOTICE
  76.  
  77.         This  documentation  is based on the software  revision  1.10  of 
  78.         November  1993.  The information in this document is  subject  to 
  79.         change   without  notice.  C.Sitte  Softwaretechnik  assumes   no 
  80.         responsibility  for  any  errors  that  may  appear  in  supplied 
  81.         materials or programs.
  82.  
  83.  
  84.         TRADEMARKS
  85.  
  86.         ASP and the ASP logo are registered trademarks of the Association 
  87.         of Shareware Professionals.
  88.         PKZIP and PKUNZIP are registered trademarks of PKWARE, Inc.
  89.  
  90.  
  91.         SHAREWARE INFORMATION
  92.  
  93.         DIFF  is distributed under the shareware marketing concept.  This 
  94.         means  that you can try the program for a limited amount of  time 
  95.         to  see if it meets your needs. After the trial period,  you  are 
  96.         required  to register and pay the registration fee or stop  using 
  97.         it.
  98.         Shareware  is a distribution method, NOT a type of software.  The 
  99.         primary difference between shareware and retail software is  that 
  100.         with shareware you know if it fits your needs BEFORE you pay  for 
  101.         it.
  102.         The  shareware system and the continued availability  of  quality 
  103.         shareware products depend on your willingness to register and pay 
  104.         for the shareware you use.
  105.         It's the registration fees you pay which allow us to support  and 
  106.         continue  to develop our products. Please show your  support  for 
  107.         shareware  by registering those programs you actually use and  by 
  108.         passing them on to others.
  109.  
  110.  
  111.         LICENSE
  112.  
  113.         Non-registered  users are granted a limited license to  try  DIFF 
  114.         for  a  period  of four weeks. After the  trial  period  you  are 
  115.         required  to  register and to pay the registration  fee  or  stop 
  116.         using it. The four week evaluation period is a legal  requirement 
  117.         based  on the license agreement, NOT a time bomb inserted in  the 
  118.         program! DIFF will not stop working or cause any damage to itself 
  119.         or your system at the end of the four week period.
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.         DISTRIBUTION
  132.  
  133.         You  are encouraged to freely copy and distribute  DIFF  provided 
  134.         that:
  135.  
  136.         1. No fee beyond normal media, duplication, and shipping costs
  137.            may be charged.
  138.  
  139.         2. It must be copied in unaltered form complete with this license
  140.            and copyright information
  141.  
  142.         3. It is advertised as "shareware" and not as "free" or "public 
  143.            domain" software.
  144.  
  145.  
  146.  
  147.         WARRANTY
  148.  
  149.         C.SITTE SOFTWARETECHNIK MAKES NO WARRANTY OF ANY KIND, EXPRESS OR 
  150.         IMPLIED,  INCLUDING  WITHOUT  LIMITATION,  ANY    WARRANTIES   OF 
  151.         MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
  152.         C.SITTE   SOFTWARETECHNIK SHALL NOT BE LIABLE FOR ANY    DAMAGES, 
  153.         WHETHER DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL ARISING FROM A 
  154.         FAILURE  OF THIS PROGRAM TO OPERATE IN THE MANNER DESIRED BY  THE 
  155.         USER. C.SITTE  SOFTWARETECHNIK SHALL NOT BE LIABLE FOR ANY DAMAGE 
  156.         TO   DATA OR PROPERTY WHICH MAY BE CAUSED DIRECTLY OR  INDIRECTLY 
  157.         BY USE OF THE PROGRAM.
  158.         IN NO EVENT WILL C.SITTE SOFTWARETECHNIK BE LIABLE TO YOU FOR ANY 
  159.         DAMAGES,  INCLUDING  ANY  LOST PROFITS, LOST  SAVINGS   OR  OTHER 
  160.         INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF  OR 
  161.         INABILITY TO USE THESE PROGRAM, EVEN IF C.SITTE   SOFTWARETECHNIK 
  162.         HAS  BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR  ANY 
  163.         CLAIM BY ANY OTHER PARTY.
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                         T A B L E   O F   C O N T E N T S
  195.                         ---------------------------------
  196.  
  197.  
  198.         1.    INTRODUCTION . . . . . . . . . . . . . . . . . . . . .    1
  199.  
  200.         2.    Shareware Copy from BBS or Disk Vendor . . . . . . . .    1
  201.  
  202.         3.    PACKING LIST . . . . . . . . . . . . . . . . . . . . .    1
  203.         3.1     Distribution . . . . . . . . . . . . . . . . . . . .    2
  204.  
  205.         4.    USAGE. . . . . . . . . . . . . . . . . . . . . . . . .    2
  206.         4.1     ARGUMENTS. . . . . . . . . . . . . . . . . . . . . .    2
  207.         4.2     COMPARISON OPTIONS . . . . . . . . . . . . . . . . .    3
  208.         4.2.1     CASE INSENSITIVE COMPARE (/c). . . . . . . . . . .    3
  209.         4.2.2     IGNORE TRAILING BLANKS (/b). . . . . . . . . . . .    3
  210.         4.2.3     EXPAND TABS BEFORE COMPARING (/x). . . . . . . . .    3
  211.         4.2.4     IGNORE SPACES AND TABS (/s). . . . . . . . . . . .    3
  212.         4.2.5     TAB SIZE (/t##). . . . . . . . . . . . . . . . . .    3
  213.         4.2.6     DISPLAY WHOLE FILE (/a). . . . . . . . . . . . . .    4
  214.         4.2.7     DISPLAY FULL LINE CONTENTS (/f). . . . . . . . . .    4
  215.         4.2.8     OUTPUT WIDTH (/w##). . . . . . . . . . . . . . . .    4
  216.         4.2.9     DISPLAY LINE NUMBERS (/n). . . . . . . . . . . . .    4
  217.         4.2.10    DIRECTORY SORTING OPTIONS. . . . . . . . . . . . .    4
  218.         4.2.10.1    SORT DIRECTORY BY TIME (/ot) . . . . . . . . . .    4
  219.         4.2.10.2    SORT DIRECTORY BY SIZE (/os) . . . . . . . . . .    4
  220.         4.2.10.3    SORT DIRECTORY BY EXTENSION (/oe). . . . . . . .    4
  221.         4.2.10.4    SORT DIRECTORY BY NAME (/on) . . . . . . . . . .    5
  222.         4.3     DIFFERENCE DISPLAY . . . . . . . . . . . . . . . . .    5
  223.         4.3.1     Example #1 . . . . . . . . . . . . . . . . . . . .    5
  224.         4.3.2     Example #2 . . . . . . . . . . . . . . . . . . . .    6
  225.         4.3.3     Example #3 . . . . . . . . . . . . . . . . . . . .    7
  226.         4.3.4     Redirection. . . . . . . . . . . . . . . . . . . .    9
  227.         4.3.5     Printing . . . . . . . . . . . . . . . . . . . . .    9
  228.         4.4     ZIP Archives . . . . . . . . . . . . . . . . . . . .    9
  229.  
  230.         5.    ORDER INFORMATION. . . . . . . . . . . . . . . . . . .   10
  231.         5.1     Site Licence . . . . . . . . . . . . . . . . . . . .   10
  232.  
  233.         6.    ASSOCIATION OF SHAREWARE PROFESSIONALS . . . . . . . .   11
  234.         6.1     ASP OMBUDSMAN STATEMENT. . . . . . . . . . . . . . .   11
  235.  
  236.         7.    To help you - help us! . . . . . . . . . . . . . . . .   12
  237.  
  238.         8.    REVISION HISTORY . . . . . . . . . . . . . . . . . . .   12
  239.  
  240.         9.    SUBJECT INDEX. . . . . . . . . . . . . . . . . . . . .   13
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.         DIFF - File/Directory Difference Utility                    V1.10
  255.  
  256.  
  257.         1.  INTRODUCTION
  258.  
  259.         DIFF  is a DOS application which displays two text files  or  two 
  260.         directories  or ZIP archive directories side by side. Common  and 
  261.         different sections are clearly marked with separator lines.
  262.  
  263.         DIFF can show the differences between:
  264.         - two text files
  265.         - a text file and a text file inside of a ZIP archive
  266.         - two directories
  267.         - a directory and a ZIP archive directory
  268.         - two ZIP archive directories
  269.  
  270.         DIFF  is especially useful for programmers who wants to  see  the 
  271.         differences between two versions of a source text file or to show 
  272.         the differences between two sets of files, where one or both sets 
  273.         can reside in a ZIP archive.
  274.         There are various formatting and comparison options available. 
  275.  
  276.  
  277.         2.  Shareware Copy from BBS or Disk Vendor
  278.  
  279.         If  you've  downloaded  an  unregistered copy  of  DIFF  from  a 
  280.         bulletin board (BBS) or an on-line service, or obtained a copy on 
  281.         diskette  or  CDROM from a disk vendor, you may try it  for  four 
  282.         weeks as specified in the shareware license agreement. After four 
  283.         weeks  you  must  either register DIFF or stop  using  it.  This 
  284.         method  of  marketing, known as "Shareware", permits you  to  try 
  285.         DIFF before you pay for it. The four week evaluation period is a 
  286.         legal requirement based on the license agreement, NOT a time bomb 
  287.         inserted in the program! DIFF will not stop working or cause any 
  288.         damage  to  itself  or your system at the end of  the  four  week 
  289.         evaluation period.
  290.  
  291.  
  292.         3.  PACKING LIST
  293.  
  294.         Shareware  copies of DIFF may be "packaged" in a variety of  ways 
  295.         depending  on who distributed them. Regardless of packaging,  the 
  296.         following files should be included:
  297.  
  298.              DIFF    .EXE    DOS File/Directory Difference Utility
  299.              DIFF    .DOC    Documentation 
  300.              ORDER   .FRM    Order Form
  301.              DESCRIBE.DOC    Product Description & Author Info
  302.              VENDOR  .DOC    Vendor/Distributor Information
  303.              FILE_ID .DIZ    Program Description for BBS's
  304.              READ    .ME     General Info and Last Minute Information
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.                                         1
  316.  
  317.         DIFF - File/Directory Difference Utility                    V1.10
  318.  
  319.  
  320.         3.1  Distribution
  321.  
  322.         You  are  encouraged to freely copy and distribute  shareware  of 
  323.         C.Sitte  Softwaretechnik provided that (see VENDOR.DOC  for  more 
  324.         information):
  325.  
  326.         1. No fee beyond normal media, duplication, and shipping costs 
  327.            may be charged.
  328.  
  329.         2. It must be copied in unaltered form complete with this license 
  330.            and copyright information.
  331.  
  332.         3. It is advertised as "shareware" and not as "free" or
  333.            "public domain" software.
  334.  
  335.  
  336.         4.  USAGE
  337.  
  338.         When  the  DIFF  program is started without  any  arguments,  the 
  339.         following usage text appears:
  340.  
  341.  
  342.          DIFF V1.10 #0000000000000 - List File/Directory/ZIP Differences
  343.          (C) Copyright 1993 C.Sitte Softwaretechnik, All rights reserved.
  344.  
  345.          usage is: diff [/options] file1 [file2|dir2|zip2]
  346.                or: diff [/options] dir1|zip1 dir2|zip2
  347.          options:
  348.           /c     case insensitive compare
  349.           /b     ignore trailing blanks
  350.           /x     expand tabs before comparing
  351.           /s     ignore spaces and tabs
  352.           /t##   tab size (1..19, default=8)
  353.           /a     display whole file
  354.           /f     display full line contents
  355.           /w##   output width (20..199, default=79)
  356.           /n     display line numbers
  357.           /ot    sort directory by time (default)
  358.           /os    sort directory by size
  359.           /oe    sort directory by extension
  360.           /on    sort directory by name
  361.           /r     registration information
  362.           /?     help
  363.  
  364.  
  365.         4.1  ARGUMENTS
  366.  
  367.         The DIFF program takes one or two filename arguments. If only the 
  368.         first argument is given, the second filename is assumed to be the 
  369.         same  filename  as the first argument,  but with an extension  of 
  370.         ".BAK".  The  second  filename can be a filename or  a  drive  or 
  371.         directory name. That means that the file with the first  filename 
  372.         is  compared  to  a  file with the same  name  in  the  specified 
  373.         drive/directory. 
  374.  
  375.  
  376.  
  377.  
  378.                                         2
  379.  
  380.         DIFF - File/Directory Difference Utility                    V1.10
  381.  
  382.  
  383.         The second filename can also be a filename of a ZIP archive. That 
  384.         means that the file with the first filename is compared to a file 
  385.         with the same name in the specified ZIP archive.
  386.         If  the first argument is not a valid filename, than a  directory 
  387.         comparison will be done. 
  388.  
  389.  
  390.         4.2  COMPARISON OPTIONS
  391.  
  392.         There are the following options available which must be specified 
  393.         before  the  filename argument(s). Options start with  the  slash 
  394.         character  ("/") as an option identifier and are followed  by  an 
  395.         option character which can be written in lower- or uppercase. Two 
  396.         or  more options could be combined in one option argument  (e.g.:  
  397.         "DIFF /abx file1" instead of "DIFF /a /b /x file1"). Options with 
  398.         numeric  arguments must be the last option in a  combined  option 
  399.         argument.
  400.  
  401.         The following options are available:
  402.  
  403.  
  404.         4.2.1  CASE INSENSITIVE COMPARE (/c)
  405.  
  406.         Upper- and lowercase is ignored on comparison.
  407.  
  408.  
  409.         4.2.2  IGNORE TRAILING BLANKS (/b)
  410.  
  411.         One  or  more blanks at the end of a line are ignored during  the 
  412.         comparison.
  413.  
  414.  
  415.         4.2.3  EXPAND TABS BEFORE COMPARING (/x)
  416.  
  417.         Tab characters (hex 09) in the text are expanded to the number of 
  418.         spaces specified in the "Tab size" (/t) option (default=8)  which 
  419.         are neccessary to reach the next tab stop. 
  420.         This option will be ignored, if the "Ignore spaces and tabs" (/s) 
  421.         option is selected.
  422.  
  423.  
  424.         4.2.4  IGNORE SPACES AND TABS (/s)
  425.  
  426.         Tab characters and spaces will be ignored on comparison.
  427.  
  428.  
  429.         4.2.5  TAB SIZE (/t##)
  430.  
  431.         The  tabsize  (number of spaces between tab stops) is  selectable 
  432.         between  1  and 19 spaces.  The default size is  8  spaces.  This 
  433.         option influences the file comparison,  if the "expand tabs" (/x) 
  434.         options is also set. 
  435.         Tabs are expanded to the given number of spaces in the difference 
  436.         display.
  437.  
  438.  
  439.  
  440.  
  441.                                         3
  442.  
  443.         DIFF - File/Directory Difference Utility                    V1.10
  444.  
  445.  
  446.  
  447.  
  448.         4.2.6  DISPLAY WHOLE FILE (/a)
  449.  
  450.         All lines (files) are displayed, not only the different sections. 
  451.  
  452.  
  453.         4.2.7  DISPLAY FULL LINE CONTENTS (/f)
  454.  
  455.         The whole contents of the textfile lines is displayed. This means 
  456.         that  continuation  lines  are used to display  the  whole  line, 
  457.         rather  than  to truncate the lines because of a  limited  output 
  458.         width.
  459.  
  460.  
  461.         4.2.8  OUTPUT WIDTH (/w##)
  462.  
  463.         The line width of the difference display can be selected  between 
  464.         20 and 199 characters. The default width is 79 characters.  Lines 
  465.         are  truncated to fit into the specified output width (if the  /f 
  466.         options is not used).
  467.  
  468.  
  469.         4.2.9  DISPLAY LINE NUMBERS (/n)
  470.  
  471.         Additional  line  numbers are displayed at the beginning  of  the 
  472.         displayed lines.
  473.  
  474.  
  475.         4.2.10  DIRECTORY SORTING OPTIONS
  476.  
  477.         There are four different directory sort options available. If  no 
  478.         sort  option is given, the default sort option (sort by time)  is 
  479.         used.
  480.  
  481.  
  482.         4.2.10.1  SORT DIRECTORY BY TIME (/ot)
  483.  
  484.         This is the default directory sorting option. Files are sorted by 
  485.         file date and file time (in that order). Newest files are at  the 
  486.         beginning of the listing.
  487.  
  488.  
  489.         4.2.10.2  SORT DIRECTORY BY SIZE (/os)
  490.  
  491.         The  files are sorted by filesize. Files with equal filesize  are 
  492.         further sorted by its filedate/time.
  493.  
  494.  
  495.         4.2.10.3  SORT DIRECTORY BY EXTENSION (/oe)
  496.  
  497.         The files are alphabetically sorted by filetype. Files with equal 
  498.         filetypes are further sorted by its filename.
  499.  
  500.  
  501.  
  502.  
  503.  
  504.                                         4
  505.  
  506.         DIFF - File/Directory Difference Utility                    V1.10
  507.  
  508.  
  509.  
  510.         4.2.10.4  SORT DIRECTORY BY NAME (/on)
  511.  
  512.         The files are alphabetically sorted by filename. Files with equal 
  513.         filenames are further sorted by its filetype.
  514.  
  515.  
  516.         4.3  DIFFERENCE DISPLAY
  517.  
  518.         By default, only the different sections between the two files  or 
  519.         directories are displayed. The files are shown side by side.  The 
  520.         first file or directory is shown at the left side, and the second 
  521.         file  or directory at the right side. Each line has  an  optional 
  522.         line  number  (/n option). Different sections also have  a  colon 
  523.         character  at  the beginning. A missing line number  (if  the  /n 
  524.         option  is selected) and a missing colon means that there  is  no 
  525.         line (file) in the corresponding file (directory).
  526.  
  527.  
  528.         4.3.1  Example #1
  529.  
  530.         The  following  example shows the differences  between  the  file 
  531.         TEST.CPP and its backup file TEST.BAK. Tabulators are expanded to 
  532.         three spaces (/t3) and the line width of the difference output is 
  533.         set  to 63 columns (/w63). Note that the third section (with  the 
  534.         'extern "C"' text) seems to be identical on the left and the  right 
  535.         side.  But there are trailing blanks on the left side line  which 
  536.         makes  it  different.  To ignore trailing blanks,  use  the  "/b" 
  537.         option.
  538.  
  539.           C> diff /t3 /w63 test.cpp
  540.  
  541.           comparing TEST.CPP with TEST.BAK
  542.           ---------------------------------------------------------------
  543.           : // diff.cpp -- main program   : // diff.cpp - main program
  544.           ---------------------------------------------------------------
  545.           :                               
  546.           ---------------------------------------------------------------
  547.           :  extern "C" {                 : extern "C" {
  548.           ---------------------------------------------------------------
  549.                                           : /////////////////////////////
  550.           ---------------------------------------------------------------
  551.           :    memset (line1, 0, sizeof   :    memset (line1, 0, sizeof (
  552.           ---------------------------------------------------------------
  553.           :             strncpy (LINE1, s :             strncpy (line1, s
  554.           ---------------------------------------------------------------
  555.           :             DIFFSTRING  str ( :             DIFFSTRING str (l
  556.           ---------------------------------------------------------------
  557.           :          printf ("----------- :          printf ("-----------
  558.           :             "---------------- 
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.                                         5
  568.  
  569.         DIFF - File/Directory Difference Utility                    V1.10
  570.  
  571.  
  572.         4.3.2  Example #2
  573.  
  574.         The following example shows the comparison of the same files, but 
  575.         with  a different set of options. Line numbers are enabled  (/n), 
  576.         trailing  blanks are ignored (note the missing section  with  the 
  577.         'extern  "C"'  text)  and  the whole contents  of  the  lines  is 
  578.         displayed  (/f). The continuation lines have a plus sign  instead 
  579.         of the colon. As many continuation lines as necessary are used to 
  580.         display the whole line contents.
  581.  
  582.  
  583.           C> diff /n /b /f /t3 /w63 test.cpp
  584.  
  585.           comparing TEST.CPP with TEST.BAK
  586.           ---------------------------------------------------------------
  587.            1: // diff.cpp -- main progra   1: // diff.cpp - main program
  588.             + m                           
  589.           ---------------------------------------------------------------
  590.            4:                             
  591.           ---------------------------------------------------------------
  592.                                           15: //////////////////////////
  593.                                             + //////////////////////////
  594.                                             + //////////////
  595.           ---------------------------------------------------------------
  596.           35:    memset (line1, 0, sizeo  35:    memset (line1, 0, sizeo
  597.             + f  (line1));                  + f (line1));
  598.           ---------------------------------------------------------------
  599.           54:             strncpy (LINE1  54:             strncpy (line1
  600.             + , str, 30);                   + , str, 30);
  601.           ---------------------------------------------------------------
  602.           64:             DIFFSTRING  st  64:             DIFFSTRING str
  603.             + r (line);                     +  (line);
  604.           ---------------------------------------------------------------
  605.           72:          printf ("--------  72:          printf ("--------
  606.             + -----------------------"      + --------------------------
  607.                                             + --------------------------
  608.                                             + ");
  609.           73:             "-------------  
  610.             + ----------------");         
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.                                         6
  631.  
  632.         DIFF - File/Directory Difference Utility                    V1.10
  633.  
  634.  
  635.         4.3.3  Example #3 
  636.  
  637.         The  following  examples are showing the comparison  between  two 
  638.         directories. Please note that only the filedate is displayed, the 
  639.         filetime is missing because of the output width limitation of  67 
  640.         characters. If you do not specifiy any output width, the  default 
  641.         output  width  of  79 characters is enough to  display  also  the 
  642.         filetime. The files one the left side are sorted by time (default 
  643.         sorting option). 
  644.         Please  note that it is also possible to specifiy a  ZIP  archive 
  645.         filename as the first or second directory parameter.
  646.  
  647.         C> diff /w67 *.* backup
  648.         comparing .\*.* with .\BACKUP\
  649.         : DBOBJECT.CXX    11472 11.11.93 : DBOBJECT.CXX    11225 28.05.93
  650.         : DBOBJECT.BAK    11474 10.11.93 
  651.         : DB30    .PRJ    10684 10.11.93 : DB30    .PRJ    11191  3.12.93
  652.         : ACCESS  .CXX     6662 10.11.93 : ACCESS  .CXX     6540 26.02.93
  653.         : DB30    .OBR      641  9.11.93 
  654.         : SERVSUB .C       1659  9.11.93 : SERVSUB .C       1657 13.04.93 
  655.         : DATABASE.CXX    18600  9.11.93 : DATABASE.CXX    18585  3.12.93
  656.         : DATABASE.BAK    18587  9.11.93 
  657.         : DBSTRUCT.C        563  7.10.93 
  658.         : SRVTABLE.CXX     5380 14.04.93 : SRVTABLE.CXX     5585  3.12.93
  659.         : SERVSUB .BAK     1657 13.04.93   
  660.  
  661.  
  662.         If you only want to see the different source text files,  specify 
  663.         a specific file extension:
  664.  
  665.         C> diff /w67 *.c* backup\*.c*
  666.         comparing .\*.C* with .\BACKUP\*.c*
  667.         : DBOBJECT.CXX    11472 11.11.93 : DBOBJECT.CXX    11225 28.05.93
  668.         : ACCESS  .CXX     6662 10.11.93 : ACCESS  .CXX     6540 26.02.93
  669.         : SERVSUB .C       1659  9.11.93 : SERVSUB .C       1657 13.04.93
  670.         : DATABASE.CXX    18600  9.11.93 : DATABASE.CXX    18585  3.12.93
  671.         : DBSTRUCT.C        563  7.10.93 
  672.         : SRVTABLE.CXX     5380 14.04.93 : SRVTABLE.CXX     5585  3.12.93
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.                                         7
  694.  
  695.         DIFF - File/Directory Difference Utility                    V1.10
  696.  
  697.  
  698.         If you also want to see the files which are the same between  the 
  699.         two directories (same date, time and size), specify also the "/a" 
  700.         option.  Please  note  that there is no comparison  of  the  file 
  701.         contents. The "/on" option sorts the directory by filename.
  702.  
  703.         C> diff /a /w67 *.c* backup\*.c*
  704.         comparing .\*.C* with BACKUP\*.C*
  705.         -----------------------------------------------------------------
  706.           ACCERROR.CXX     1841 15.03.93   ACCERROR.CXX     1841 15.03.93
  707.         -----------------------------------------------------------------
  708.         : ACCESS  .CXX     6662 10.11.93 : ACCESS  .CXX     6540 26.02.93
  709.         : DATABASE.CXX    18600  9.11.93 : DATABASE.CXX    18585  3.12.93
  710.         : DBOBJECT.CXX    11472 11.11.93 : DBOBJECT.CXX    11225 28.05.93
  711.         -----------------------------------------------------------------
  712.           DBPARSE .CXX     1857  5.04.93   DBPARSE .CXX     1857  5.04.93
  713.           DBSTRING.CXX    12346 10.02.93   DBSTRING.CXX    12346 10.02.93
  714.         -----------------------------------------------------------------
  715.         : DBSTRUCT.C        563  7.10.93 
  716.         -----------------------------------------------------------------
  717.           DLIST   .CXX     2921 10.02.93   DLIST   .CXX     2921 10.02.93
  718.           ERRTEXT .CXX     3807 10.02.93   ERRTEXT .CXX     3807 10.02.93
  719.           FNCINFO .CXX     5664 10.02.93   FNCINFO .CXX     5664 10.02.93
  720.           LOGFILE .CXX     2672 15.03.93   LOGFILE .CXX     2672 15.03.93
  721.           LUW     .CXX     6536 28.05.93   LUW     .CXX     6536 28.05.93
  722.           SERVER  .CXX     2069  7.04.93   SERVER  .CXX     2069  7.04.93
  723.         -----------------------------------------------------------------
  724.         : SERVSUB .C       1659  9.11.93 : SERVSUB .C       1657 13.04.93
  725.         : SRVTABLE.CXX     5380 14.04.93 : SRVTABLE.CXX     5585  3.12.93
  726.         -----------------------------------------------------------------
  727.           TEXTFILE.CXX     6544 21.04.93   TEXTFILE.CXX     6544 21.04.93
  728.           TRANSACT.CXX     3386 11.02.93   TRANSACT.CXX     3386 11.02.93
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.                                         8
  757.  
  758.         DIFF - File/Directory Difference Utility                    V1.10
  759.  
  760.  
  761.         4.3.4  Redirection
  762.  
  763.         The  output  of the comparison can be redirected into a  file  or 
  764.         piped into another program.
  765.  
  766.           C> diff test.cpp test.old > test.dif
  767.  
  768.           C> diff test.cpp d: | more
  769.  
  770.  
  771.         4.3.5  Printing
  772.  
  773.         To print the differences between two versions of a text file  you 
  774.         could  use one of two methods. One way is to redirect the  output 
  775.         of  the  comparison  directly to the  printer  device  ("PRN"  or 
  776.         "LPT1"...). Use the "output width" parameter (/w##) to adjust the 
  777.         output width to your printer width.
  778.  
  779.           C> diff /w78 test.cpp test.bak > prn
  780.  
  781.  
  782.         Another  way  is to redirect the output of the  comparison  to  a 
  783.         textfile  and use any convenient printing tool to print  it  out. 
  784.         For  example, select a wide output width (/w160) and print it  in 
  785.         landscape  mode on a laserprinter to see complete lines  side  by 
  786.         side.
  787.  
  788.           C> diff /w165 test.cpp test.bak > test.dif
  789.           C> 4print -wide test.dif
  790.  
  791.  
  792.  
  793.         4.4  ZIP Archives
  794.  
  795.         If a textfile is compared with another textfile in a ZIP archive, 
  796.         the  file  in the ZIP archive is extracted to  a  temporary  file 
  797.         which is deleted after the comparison. To extract files inside of 
  798.         ZIP  archives,  it  is necessaryy that  the  PKUNZIP  utility  is 
  799.         available on your system.
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.                                         9
  820.  
  821.         DIFF - File/Directory Difference Utility                    V1.10
  822.  
  823.  
  824.         5.  ORDER INFORMATION
  825.  
  826.         The registration fee for a single copy of DIFF (tm) is US$ 15.-. 
  827.         Payment of this fee entitles you to:
  828.  
  829.         *  Disk with the latest version of DIFF which does not display
  830.            the shareware notices and registration reminders.
  831.  
  832.         *  Printed manual
  833.  
  834.         *  Free support by electronic mail or by mail for the
  835.            first six month after payment.
  836.  
  837.         *  Additional disk labels for the number of ordered copy
  838.            licences.
  839.  
  840.         *  Notification of the next major upgrade.
  841.  
  842.         *  Shareware Versions of other products of
  843.            C.Sitte Softwaretechnik
  844.  
  845.  
  846.         The  following per-unit prices apply for registration of  one  or 
  847.         more copies of DIFF on the same order form:
  848.  
  849.             1           US$ 15.-
  850.             2 -  9      US$ 10.-
  851.             10+         (negotiable)
  852.  
  853.         5.1  Site Licence
  854.  
  855.         It  is also possible to obtain an additional  site licence  (copy 
  856.         license).  A  minimum  of one disk  with  documentation  must  be 
  857.         ordered. The licensee is responsible for duplicating the diskette 
  858.         and documentation as needed, and for ensuring that the number  of 
  859.         installed copies is not exceeded. Additional disk labels for  the 
  860.         number of ordered copy licences will be delivered.
  861.  
  862.             25  User    US$ 120.-
  863.             50  User    US$ 200.-
  864.             100 User    US$ 320.-
  865.             100+        (negotiable)
  866.  
  867.         An additional shipping & handling charge of US$ 5.- must be added 
  868.         to the total amount.
  869.  
  870.         Payments  can be made by credit card  (MC/Visa/AmEx/JCB),   cash, 
  871.         international  postal  money order or eurocheque. If you  use  an 
  872.         check which is not drawn on an austrian bank, please add  another 
  873.         US$ 5.- for bank charges.
  874.  
  875.         The accompanying file ORDER.FRM includes a detailed order form.
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.                                         10
  883.  
  884.         DIFF - File/Directory Difference Utility                    V1.10
  885.  
  886.  
  887.         6.  ASSOCIATION OF SHAREWARE PROFESSIONALS
  888.  
  889.         C.Sitte Softwaretechnik is an author member of the Association of 
  890.         Shareware   Professionals  (ASP),  an  organization   formed   to 
  891.         strengthen the future of shareware. Its members, all of whom  are 
  892.         programmers  who subscribe to a code of ethics, are committed  to 
  893.         the concept of shareware as a method of marketing.
  894.  
  895.         The  ASP  sets  standards for its  members  and  their  shareware 
  896.         products which provide that programs produced by ASP members must 
  897.         be  fully documented, non-crippled, and offered with at  least  a 
  898.         minimum  level of support. It also sets standards  for  shareware 
  899.         disk  vendors  and  provides  information  to  the  public  about 
  900.         shareware.
  901.  
  902.  
  903.                               ⁄ƒƒƒƒƒƒƒø
  904.                          ⁄ƒƒƒƒ¡ƒƒø    ≥                (R)
  905.                        ƒƒ≥       ≥    ≥ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ
  906.                          ≥  ⁄ƒƒƒƒ¡ƒƒø ≥  Association of
  907.                          ≥  ≥       ≥ƒŸ  Shareware
  908.                          ¿ƒƒ≥   o   ≥    Professionals
  909.                        ƒƒƒƒƒ≥   ≥   ≥ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ
  910.                             ¿ƒƒƒ¡ƒƒƒŸ    MEMBER
  911.  
  912.  
  913.  
  914.         6.1  ASP OMBUDSMAN STATEMENT
  915.  
  916.         This  program  is  produced by a member  of  the  Association  of 
  917.         Shareware  Professionals (ASP). ASP wants to make sure  that  the 
  918.         shareware principle works for you. If you are unable to resolve a 
  919.         shareware-related  problem with an ASP member by  contacting  the 
  920.         member  directly, ASP may be able to help. The ASP Ombudsman  can 
  921.         help  you  resolve a dispute or problem with an ASP  member,  but 
  922.         does not provide technical support for members' products.  Please 
  923.         write  to  the  ASP Ombudsman at 545 Grover  Road,  Muskegon,  MI 
  924.         49442-9427, USA or send a CompuServe message via CompuServe  Mail 
  925.         to ASP Ombudsman 70007,3536.
  926.         The  Ombudsman may be contacted by FAX by sending to the ASP  FAX 
  927.         number:  (616)  788-2765.  In communication  with  the  Ombudsman 
  928.         please include a telephone number and/or FAX if available.
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.                                         11
  946.  
  947.         DIFF - File/Directory Difference Utility                    V1.10
  948.  
  949.  
  950.         7.  To help you - help us!
  951.  
  952.         If  you  have questions about the DIFF  File  Difference  Utility 
  953.         please describe your problem as detailed as possible, so that  we 
  954.         are able to simulate it according to your information.
  955.  
  956.  
  957.         Send this information to us via mail or electronic mail:
  958.  
  959.         Mail:     C.SITTE SOFTWARETECHNIK
  960.                   Postfach 42
  961.                   A-5025 Salzburg, Austria
  962.                
  963.         Electronic Mail:
  964.               *   CompuServe: 73030,1070
  965.               *   Internet  : 73030.1070@compuserve.com
  966.               *   Uunet     : uunet!compuserve.com!73030.1070
  967.  
  968.               *   X400      : Country=us
  969.                               ADMD=CompuServe
  970.                               PRMD=csmail
  971.                               DDA Type=id
  972.                               DDA Value=73030.1070
  973.  
  974.               *   MCI users should enter these values 
  975.                   at the following prompts:
  976.                          To : Chris Sitte (ems)
  977.                          EMS: CompuServe
  978.                          MBX: p=csmail
  979.                          MBX: d=id=73030.1070
  980.  
  981.  
  982.         8.  REVISION HISTORY
  983.  
  984.         DIFF      v1.01     May/93    Initial release of DIFF
  985.         DIFF      v1.10     Nov/93    also show directory differences
  986.                                       and ZIP archive differences
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.                                         12
  1009.  
  1010.         SUBJECT INDEX
  1011.  
  1012.  
  1013.         9.  SUBJECT INDEX
  1014.  
  1015.  
  1016.  
  1017.         A
  1018.         ARGUMENTS,  2
  1019.         ASP OMBUDSMAN STATEMENT,  11
  1020.         ASSOCIATION OF SHAREWARE PROFESSIONALS,  11
  1021.  
  1022.  
  1023.         C
  1024.         CASE INSENSITIVE COMPARE (/c),  3
  1025.         COMPARISON OPTIONS,  3
  1026.  
  1027.  
  1028.         D
  1029.         DIFFERENCE DISPLAY,  5
  1030.         DIRECTORY SORTING OPTIONS,  4
  1031.         DISPLAY FULL LINE CONTENTS (/f),  4
  1032.         DISPLAY LINE NUMBERS (/n),  4
  1033.         DISPLAY WHOLE FILE (/a),  4
  1034.         Distribution,  2
  1035.  
  1036.  
  1037.         E
  1038.         Example #1,  5
  1039.         Example #2,  6
  1040.         Example #3,  7
  1041.         EXPAND TABS BEFORE COMPARING (/x),  3
  1042.  
  1043.  
  1044.         I
  1045.         IGNORE SPACES AND TABS (/s),  3
  1046.         IGNORE TRAILING BLANKS (/b),  3
  1047.         INTRODUCTION,  1
  1048.  
  1049.  
  1050.         O
  1051.         ORDER INFORMATION,  10
  1052.         OUTPUT WIDTH (/w##),  4
  1053.  
  1054.  
  1055.         P
  1056.         PACKING LIST,  1
  1057.         Printing,  9
  1058.  
  1059.  
  1060.         R
  1061.         Redirection,  9
  1062.         REVISION HISTORY,  12
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.                                         13
  1072.  
  1073.         SUBJECT INDEX
  1074.  
  1075.  
  1076.         S
  1077.         Shareware Copy from BBS or Disk Vendor,  1
  1078.         Site Licence,  10
  1079.         SORT DIRECTORY BY EXTENSION (/oe),  4
  1080.         SORT DIRECTORY BY NAME (/on),  5
  1081.         SORT DIRECTORY BY SIZE (/os),  4
  1082.         SORT DIRECTORY BY TIME (/ot),  4
  1083.         SUBJECT INDEX,  13
  1084.  
  1085.  
  1086.         T
  1087.         TAB SIZE (/t##),  3
  1088.         To help you - help us!,  12
  1089.  
  1090.  
  1091.         U
  1092.         USAGE,  2
  1093.  
  1094.  
  1095.         Z
  1096.         ZIP Archives,  9
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.                                         14
  1135.  
  1136.